Skip to content

docs(macos): install steps that actually cover the Accessibility and Automation grants - #202

Merged
jonocodes merged 1 commit into
mainfrom
docs/macos-install-permissions
Nov 19, 2026
Merged

jonocodes merged 1 commit into
mainfrom
docs/macos-install-permissions

Conversation

@jonocodes

Copy link
Copy Markdown
Owner

Installing deckd from the DMG left it looking half-working: decks followed the focused app, but the trackpad, scroll strip and shortcut buttons (e.g. Firefox "New window") silently did nothing. The homepage said "allow Accessibility when asked", but macOS never asks for it; you have to add deckd yourself. And because the app is ad-hoc signed, every upgrade quietly invalidates the grants (#194).

This rewrites the Mac install instructions around the permissions:

  • Guide: the macOS app section is now an install walkthrough: install, grant permissions (a table of what breaks without Accessibility / Automation → System Events / Screen Recording, plus the log lines that identify each), LAN access, upgrading (tccutil reset … com.deckd.daemon, then grant again), and building it yourself. It also records today's real-hardware check: with both grants in place, deck switching, trackpad, scroll and shortcuts all worked from a phone.
  • README: a Mac DMG route at the top of Getting started.
  • Homepage: corrected macOS install tab, and an FAQ entry for "decks switch but buttons do nothing".

The homepage links to the new #grant-permissions / #upgrading guide anchors, which resolve once this merges. Related: #194, #195, #200.

Created with Claude Opus 5.5 in Claude Code.

🤖 Generated with Claude Code

…n grants

The DMG install docs and the homepage said "allow Accessibility when
asked", but macOS never asks for it. Without it deckd looks half-working:
decks follow the focused app while the trackpad, scroll strip and
shortcut buttons silently do nothing. Ad-hoc signing also makes every
upgrade a new app to TCC, so grants silently go stale.

- GUIDE: the macOS app section becomes an install guide (install, grant
  permissions with a what-breaks table and log signatures, LAN access,
  upgrading with tccutil reset, building it yourself) and records the
  2026-11-18 real-hardware verification.
- README: a Mac DMG route at the top of Getting started.
- Homepage: corrected macOS install tab, plus an FAQ entry for "decks
  switch but buttons do nothing".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jonocodes
jonocodes merged commit 00d5f14 into main Nov 19, 2026
4 checks passed
@jonocodes
jonocodes deleted the docs/macos-install-permissions branch November 19, 2026 00:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant